home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / status36.zip / STATUS.DOC < prev    next >
Text File  |  1993-07-02  |  20KB  |  442 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                         Network Mail Status - Postlink Version
  8.           =================================================================
  9.  
  10.                First off I would like to thank those users who have offered
  11.           suggestions  and  made comments  on  Status.  Some functions  and
  12.           displays, even CleanUp, are the direct result of this input.
  13.  
  14.                (1) Generates a network  Export mail status bulletin showing
  15.           each conference  (full 24  characters in conference  names), 1000
  16.           maximum, and the  total number of  messages exported for  current
  17.           date and  total to date  for each conferences,  total conferences
  18.           and the total messages to date for the specified network.
  19.  
  20.                (2) Generates a network Import mail status bulletin with the
  21.           same  format as  the Export  bulletin.  Since the  export routine
  22.           contains all conference names it is run first  to get those names
  23.           so  that conferences with zero imports are still displayed in the
  24.           import  bulletin. I  could  not  find  another  way  to  get  all
  25.           conference names.
  26.  
  27.                (3)  Generates  last  import  bulletin  showing last  import
  28.           information: date, time, total messages import in last import and
  29.           total messages imported to date.
  30.  
  31.                (4)  Generates, or appends to  the end of,  a monthly totals
  32.           bulletin  called  network.TOT with  each rollover.  This bulletin
  33.           contains  the  total  lines   from  previous  Export  and  Import
  34.           bulletins along with header.
  35.  
  36.                Supports multiple  networks.  This program  uses  Postlink's
  37.           export  /  import log(s).  Single or  separate Import  and Export
  38.           logs. It does a monthly rollover of the LOG(s) using PKZIP.EXE.
  39.  
  40.                This archive should contain the following files:
  41.  
  42.                CLEANUP.DOC........... Instructions for running CleanUp
  43.                CLEANUP.EXE........... Postlink log reduction utility
  44.                DOORS.TXT............. Current list of James Huckabey doors
  45.                FILE_ID.DIZ........... BBS description file
  46.                READ.ME............... Update/changes information
  47.                STATUS.BAT............ Sample batch file
  48.                STATUS.EXE............ Actual Status program
  49.                STATUS.DOC............ Instructions for running Status
  50.                STATUS.CFG............ Sample configuration file     
  51.                STATUS2.CFG........... Sample configuration file
  52.                STATUS3.CFG........... Sample configuration file
  53.                SUPPORT.TXT........... Location of Support BBS
  54.                ARCHIVE.TXT........... This list of files
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                Syntax is pretty straight forward:
  61.  
  62.                                   STATUS STATUS.CFG
  63.  
  64.                Full path  to STATUS.EXE may  be used if  not in path  or in
  65.           current  directory.  If  you do  use  a  path  statement in  your
  66.           execution  of Status (not in current dir  or in path) you need to
  67.           set the environment variable "SET STATUS=path to STATUS.EXE" (SET
  68.           STATUS=C:\UTILITY\OTHER, etc. no ending slash is needed).
  69.  
  70.                It  is  not  necessary  to  add  a  path  statement  to  the
  71.           configuration file since the program  finds itself. Of course the
  72.           file must be in location of STATUS.EXE. If the configuration file
  73.           is not in  the same location then use the  path statement to it's
  74.           location. 
  75.  
  76.                "STATUS.CFG" and can  have any file name  with the following
  77.           format. You can use up  to 8 characters of your network  name for
  78.           the  name  of your  .CFG file  if  that helps  keep multi-network
  79.           configurations clearer. This would  be the easiest way to  do it.
  80.           Each  line must  be  populated  with  a  valid  entry.  Paths  to
  81.           bulletins or logs are not needed if they are in or written to the
  82.           current directory:
  83.  
  84.                          (1) Unregistered BBS
  85.                          (2) 0000
  86.                          (3) Network
  87.                          (4) POST1.LOG
  88.                          (5) C:\BBS\BLT7
  89.                          (6) POST2.LOG
  90.                          (7) C:\BBS\BLT77
  91.                          (8) C:\BBS\BLT777
  92.                          (9) PCB
  93.  
  94.                                      CFG line #1
  95.  
  96.                "Unregistered BBS", system name if registered
  97.  
  98.                                      CFG line #2
  99.  
  100.                "0000", valid serial number if registered.
  101.  
  102.                                      CFG line #3
  103.  
  104.                "Network" should be the  name of the actual network  you are
  105.           using, one word  and case sensitive  (Rime, AccessNet, etc.).  18
  106.           characters max,  longer names are  truncated. Say you  are making
  107.           two different network mail runs with the same software, you would
  108.           use those names here, each in it's own configuration file.
  109.            
  110.                                      CFG line #4
  111.  
  112.                "POST1.LOG" is  the path  and name  of your  Postlink Export
  113.           log.  Lines #4  and #6  can contain  the same  file name  if your
  114.  
  115.  
  116.  
  117.  
  118.  
  119.           Export and Import logs are in one file.
  120.  
  121.                                      CFG line #5
  122.  
  123.                "C:\BBS\BLT7" is the path and name for your Export bulletin.
  124.  
  125.                                      CFG line #6
  126.  
  127.                "POST2.LOG"  is the path  and name  of your  Postlink Import
  128.           log.  Lines #4  and #6  can contain  the same  file name  if your
  129.           Export and Import logs are in one file.
  130.  
  131.                                      CFG line #7
  132.  
  133.                "C:\BBS\BLT77"  is  the  path   and  name  for  your  Import
  134.           bulletin.
  135.  
  136.                                      CFG line #8
  137.  
  138.                "C:\BBS\BLT777" is  the path and  name for your  Last Import
  139.           bulletin. If you are not  using this option the file can  just be
  140.           written out to the current directory, but it must be generated.
  141.  
  142.                                      CFG line #9
  143.  
  144.                Color  and characters  used are  setup to  give you  as much
  145.           control over the output as  possible. Not all users can read  and
  146.           handle IBM extended graphic characters (like sight impaired users
  147.           and  voice  hardware).  Program can  use  either  "=/-"  or IBM's
  148.           extended graphic  characters "═/─". Line  #9 must contain  one of
  149.           the following options:
  150.  
  151.                "PCB" use IBM extended  graphic characters and PCBoard's @X0
  152.           colorizing codes.
  153.  
  154.                "PCB0" use no IBM  extended graphic characters and PCBoard's
  155.           @X0 colorizing codes.
  156.  
  157.                "ANSI"  use   colorizing  and   no   IBM  extended   graphic
  158.           characters.
  159.  
  160.                "ANSI2" use colorizing and IBM extended graphic characters.
  161.  
  162.                "ASCII"  use  no  colorizing  and no  IBM  extended  graphic
  163.           characters.
  164.  
  165.                "ASCII2"  use no  colorizing, but  use IBM  extended graphic
  166.           characters.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.                                  STATUS TOTAL FILE(s)
  173.  
  174.                This  file,  Status  Totals,   is  written  to  the  current
  175.           directory only. Current directory is the directory where you call
  176.           STATUS.EXE from.  The file name  is the first  eight alphabetical
  177.           characters  of  your network  name. That  way  if you  are making
  178.           multiple network mail runs each network will have it's own totals
  179.           file. The extension is always "TOT".
  180.  
  181.                Please  make note  that  if  your  copy  of  Status  is  not
  182.           registered that  the total file  will have "Unregistered  BBS" in
  183.           the BBS line of the  bulletin. If you keep the file  and register
  184.           Status  you will  have to edit  the top  line of  the bulletin or
  185.           erase it and start over.
  186.  
  187.                This file/bulletin  has unlimited possibilities.  If you are
  188.           making more than one Status execution, say for different formats,
  189.           only  the first one will  be executed with  the rollover. So this
  190.           file will only  contain that  color format. It  is complete  with
  191.           whatever color codes existed in the original bulletin. The colors
  192.           can be removed or replaced with whatever colors you want manually
  193.           using a text editor.
  194.  
  195.                The file has  a three  line header when  first created,  (1)
  196.           line with BBS name in it, (2) an explanation of what it is, (3) a
  197.           header  termination line. It then  has one line  for Export total
  198.           and  one line  for Import  total followed  by a  blank separation
  199.           line. Each successive  appendage is three  lines total. A  year's
  200.           worth of information would have a total of thirty-nine lines.
  201.  
  202.                What you do with this information is up to you. Just another
  203.           friendly option added to the program.  If you are going to use it
  204.           as an  active bulletin it  can be copied anywhere  you want. Just
  205.           make sure that if you want the next rollover appended  to the end
  206.           that you keep the file in the current directory for the execution
  207.           of  Status.  If you  change this  make  sure you  move  the total
  208.           bulletin(s).
  209.  
  210.                It should be noted that when you start using Status  for the
  211.           first  time that if your Postlink log(s) are not just the current
  212.           month's log(s) that the log does not roll over until the month in
  213.           the log equals  your system's current month (change  from earlier
  214.           versions). The first archive will contain everything to date. The
  215.           new log will start at the first current month's date Status finds
  216.           in  the  current  month's  log.  Bulletins  generated  will  show
  217.           information only for  the current  month and from  this point  on
  218.           each  roll over  archive will  contain only the  previous month's
  219.           log.
  220.  
  221.  
  222.  
  223.  
  224.  
  225.                                         Errors
  226.  
  227.                Errors  are written to the same directory as STATUS.EXE in a
  228.           file  called STATUS.ERR.  If the  file already  exists additional
  229.           errors are  appended to the  end of the  file. It may  be deleted
  230.           after you have  made note of  any errors. It's  existence it  not
  231.           required by the program.
  232.  
  233.                During  the  start  up  procedures  that  program   displays
  234.           "Searching!" while it is looking for the directory STATUS.EXE  is
  235.           located  in.  Also  "Configuring!" while  it  is  reading  in and
  236.           verifying all  the information  in the configuration  file. These
  237.           are to show to show you what the program is  doing should lockups
  238.           occur.  I  had problems  in these  areas  and took  some  time to
  239.           isolate them. At least  now these problem areas can  be isolated.
  240.           Normally  these two displays should  be very quick and unreadable
  241.           depending on system speed and Status' configuration.
  242.  
  243.                I have changed  the way the  programs handles errors  during
  244.           the  configuration process.  If Status  has trouble with  the log
  245.           files, like finding it/them, it first tries  to create a "no data
  246.           bulletin" and do an normal error exit. If it  cannot create these
  247.           bulletins  is makes the error exit that displays the help screen.
  248.           These two exits would  normally be an error in  the configuration
  249.           file: wrong path, wrong file name, etc.
  250.  
  251.  
  252.  
  253.  
  254.  
  255.                                     Using Postlink
  256.  
  257.                If  you are making two  or more DIFFERENT  network mail runs
  258.           the  only  thing you  must  do  is  make  two or  more  different
  259.           POSTLINK.CFG  files, one with  the name of the  LOG file for each
  260.           network so that  ALL logs are not put into one file. I would have
  261.           no way of knowing  what messages came from what  network in order
  262.           to separate them. You would then just have a TEMP1.CFG, TEMP2.CFG
  263.           and when you call postlink you just  copy TEMP1.CFG POSTLINK.CFG,
  264.           then on next run you might copy TEMP2.CFG POSTLINK.CFG, etc.
  265.  
  266.                A simple batch file might look like one of these:
  267.  
  268.                     SET STATUS=C:\UTILITY
  269.                     CD \POSTLINK
  270.                     COPY TEMP1.CFG POSTLINK.CFG
  271.                     POSTLINK CALLER.CFG
  272.                     STATUS STATUS.CFG
  273.                     SET STATUS=
  274.  
  275.  
  276.                     SET STATUS=C:\UTILITY
  277.                     CD \POSTLINK
  278.                     Copy TEMP2.CFG POSTLINK.CFG
  279.                     POSTLINK CALLER2.CFG
  280.                     C:\UTILITY\STATUS STATUS2.CFG
  281.                     SET STATUS=
  282.  
  283.  
  284.  
  285.  
  286.  
  287.                Perhaps you want  to make  a bulletin with  the PCBoard  @X0
  288.           codes  and one using straight  ASCII codes and  yet another using
  289.           ANSI codes. The .CFG  files would contain the bulletin  names and
  290.           the form setting (#9):
  291.  
  292.                STATUS STATUS.CFG
  293.                (.CFG with PCB, uses ANSI codes and IBM extended graphic
  294.                 characters)
  295.  
  296.                STATUS STATUS2.CFG
  297.                (.CFG with ASCII, ASCII and no IBM extended graphic
  298.                 characters)
  299.  
  300.                STATUS STATUS3.CFG
  301.                (.CFG with ANSI, ANSI colors and no IBM extended graphic
  302.                 characters)
  303.  
  304.                You just call STATUS  as many times as needed,  with as many
  305.           configuration files  as needed  to generate whatever  formats you
  306.           want. On my  386/33 it takes less than twenty  seconds to run the
  307.           program on a 6,500 line test log (from three BBS systems).
  308.  
  309.                                   The Status Program
  310.  
  311.                If you don't like the program please write to me and explain
  312.           why. Send me any suggestions you  might have. If they enhance the
  313.           overall program I will try to incorporate part, some, all, in the
  314.           next release.
  315.  
  316.                 This program package represents many hours of  programming,
  317.           testing,  updating and more testing as well as LD telephone calls
  318.           to get it tested  and to distribute the beta and  release copies.
  319.           Please support my efforts and register your copy.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                          PKZIP.EXE used by the Status Program
  326.  
  327.                "PKZIP.EXE" must be somewhere in your path or in the current
  328.           directory. When  the month  changes in the  export/import.log the
  329.           program  archives the  current log  into a  file using  'ML'+ the
  330.           current date  (ML010193.ZIP, etc.). It also  includes the current
  331.           logs (1 or  2) and all  three bulletins. It  creates this in  the
  332.           directory  that  contains  the  log  file(s).  The  program  then
  333.           rewrites  the log using only  the current new  month's data. This
  334.           way there is only one month's log data in your Postlink log(s).
  335.  
  336.                I  have made a work  around for the  archiving problems with
  337.           the  log(s)  while  SHARE.EXE  is  loaded.  The  work  around  is
  338.           invisible to you. Well, almost invisible!
  339.  
  340.                The  bulletins  are   added  to  the  archive  so  the  last
  341.           information posted on the BBS before rollover is available should
  342.           this information be required by the you.
  343.  
  344.                If you do not want the previous month's log(s) simply delete
  345.           the archive from your hard drive. In  your calling batch file you
  346.           can  add "IF EXIST ML*.ZIP DEL ML*.ZIP" and this will auto-delete
  347.           the archive.
  348.  
  349.                If the program  has any  problems with your  log(s) such  as
  350.           file  not found,  no exported  conferences found,  a bulletin  is
  351.           generated showing  that there was an error in the log and that no
  352.           imported/exported messages  were  found. The  program  aborts  on
  353.           these errors. The program confirms each item in the configuration
  354.           file before it does anything else. See errors below
  355.  
  356.                There must  be at least one  meg of free disk  space for the
  357.           archive to  be executed. I have no idea the possible sizes and if
  358.           anyone has problems with the archive with one meg as the  minimum
  359.           please let me know and I will increase the size of the free space
  360.           needed. I have been  unable to trap PKZIP.EXE errors  from within
  361.           my  Turbo Pascal 7.0 programs.  I believe PKZIP  handles them and
  362.           does not pass them along to operating system.
  363.  
  364.  
  365.  
  366.  
  367.  
  368.                                  Status Registration
  369.  
  370.                Send BBS information and one of the following in $ U.S.
  371.  
  372.                (1) Registration only via routed node ID..............$10
  373.                Not a safe or reliable form of registration.
  374.  
  375.                (2) Registration only via mail........................$10
  376.                (outside U.S. please add $2) Better registration.
  377.  
  378.                (3) Registration and latest version via mail......... $12
  379.                (outside U.S. please add $4) Include diskette size.
  380.  
  381.                (4) Registration and latest version via mail and
  382.                copy of all James Huckabey Doors and PC software..... $15
  383.                (outside U.S. please add $5) Include diskette size.
  384.  
  385.                (5)  Limited Special Registration of Status and StatusC
  386.                add $5 to any of the above options. *** Offer good only
  387.                through August 15, 1993 ***
  388.  
  389.                Option: 1: [ ]   2: [ ]     3: [ ]     4: [ ]     5: [ ]
  390.  
  391.                Diskette Size: 360: [ ]   1.2: [ ]   720: [ ]  1.44: [ ]
  392.  
  393.                Your current version number: [     ]
  394.  
  395.                Please  supply name  of BBS to  be added  to program,  up to
  396.           sixty characters. Anything longer than that will be truncated, no
  397.           exceptions. This is to be on one line of code and must be legible
  398.           since the  serial number is  based on  exact syntax. I  cannot be
  399.           responsible for unreadable data. Please print. Case sensitive!
  400.  
  401.           Example:  "Jim's Graphic  BBS". In  StatusC it  comes out  as the
  402.           following in all bulletins generated:
  403.  
  404.                ==================(Jim's Graphic BBS)==================
  405.  
  406.  
  407.            [-------------------------------------------------------------]
  408.  
  409.           FROM: 
  410.                   Name: 
  411.                        ---------------------------------------------------
  412.                Address:  
  413.                        ---------------------------------------------------
  414.                   City: 
  415.                        ---------------------------------------------------
  416.            State & Zip: 
  417.                        ---------------------------------------------------
  418.                 HUB ID:                       NODE ID:
  419.                        ----------------------         --------------------
  420.           Phone(voice):                        (data)
  421.                        ---------------------         ---------------------
  422.  
  423.  
  424.  
  425.  
  426.  
  427.                Your registration  number and  any diskettes,  if requesting
  428.           current version or other software, are sent by return mail or via
  429.           Rime  and routed Node  ID if this  is your choice.  E-Mail is not
  430.           that reliable.
  431.  
  432.                     James Huckabey
  433.                     3621-A Fraser Street
  434.                     Bellingham, Washington 98226 U.S.A.
  435.                     (206) 671-2868 (voice) I do have a USR 14.4 DS!
  436.  
  437.                You can also contact me at:
  438.  
  439.                     Corporate Headquarters BBS
  440.                     Sysop: Bob Neal
  441.                     RelayNet (tm): CHQBBS (#1255)
  442.                     (815) 886-3233 or 886-9381 (14400 V32bis)